home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / TPYRA120.ZIP / PYRAMID.DOC < prev    next >
Encoding:
Text File  |  1996-02-25  |  14.1 KB  |  323 lines

  1.                    T&T Software
  2.                   PYRAMID V1.20
  3.                 (c) Copyright 1994
  4.  
  5. ╔════════════════════════════════════════════════════════════════════════╗
  6. ║  ■ PYRAMID V1.20 Overview & Instructions ■                             ║
  7. ╚════════════════════════════════════════════════════════════════════════╝
  8. ═ Overview ═
  9. PYRAMID will ONLY support ANSI mode, this will be checked upon program start
  10. up and if ANSI is NOT on the user will be asked if they can support ANSI.  If
  11. the user responds "Y" then ANSI is turned on for the duration of the door but
  12. is turned off when the door exits!  If the user responds "N" then they are
  13. returned to the BBS.
  14.  
  15. The users will be allowed to play upto the maximum amount of games allowed
  16. per day (set by the SysOp in Registered Versions ONLY, default: 10).
  17.  
  18. Free games are awarded when the pyramid is cleared and when the game is
  19. totally won!
  20.  
  21. The SysOp may also set the amount of times to allow the user to go through
  22. the stock pile, this is designed to make the game easier to win!  (set
  23. by the SysOp in Registered Versions ONLY, default: 1).
  24.  
  25. The SysOp may also set the amount of make up days that may be played per
  26. day. (set by the SysOp in Registered Versions ONLY, default: 1).  When a
  27. user chooses to make up a day a calendar is displayed (CALENDAR.ANS), if
  28. you do not want this calendar to be displayed simply delete it.  If the
  29. user chooses to make up a day, the current days statistics are just reset,
  30. but you can NOT make up days until all of the current days games have been
  31. played.
  32.  
  33. The Sysop has the option to change the playing screen background and the
  34. playing card colors via the key file (REGISTERED VERSIONS ONLY, default:
  35. white on white).
  36.  
  37. Users may quit out of the door and their information will be saved in
  38. PYRAMID.DAT so they can come back in and finish their games anytime the same
  39. day.
  40.  
  41. ═ Instructions ═
  42. Create a directory for PYRAMID and unarchive or copy all the files into that
  43. directory.
  44.  
  45. Create configuration files for each node that you wish to run PYRAMID on. 
  46. (See the example configuration files for details).
  47.  
  48. The door can be run with one command line parameter:
  49.  
  50. PYRAMID NODE1.CFG <-- Configuration filename
  51.  
  52. if this parameter is left off PYRAMID looks for PYRAMID.CFG and uses it if
  53. found, if it is not found then the program will abort.
  54.  
  55. To run in the local mode, simply log onto the BBS and run the door or you can
  56. play it without the BBS by setting the LocalMode in the configuration file and
  57. then running PYRAMID <config.file>.
  58.  
  59. ****Special Configuration File Note****
  60. The configuration file looks really overpowering, but don't shy away from it!
  61. Everything you need to know about the configuration file is within the
  62. configuration file!
  63.  
  64. ╔════════════════════════════════════════════════════════════════════════╗
  65. ║  ■ PYRAMID Drop File Support ■                                         ║
  66. ╚════════════════════════════════════════════════════════════════════════╝
  67. PYRAMID will support the following drop files:
  68.  
  69.   1.  DORINFO?.DEF       6.  SFDOORS.DAT
  70.   2.  EXITINFO.BBS       7.  SFMAIN.DAT
  71.   3.  CHAIN.TXT          8.  SFMESS.DAT
  72.   4.  CALLINFO.BBS       9.  SFFILE.DAT
  73.   5.  DOOR.SYS          10.  SFSYSOP.DAT
  74.   
  75. and any other with the use of the CustomFile in the configuration file.
  76.  
  77. ╔════════════════════════════════════════════════════════════════════════╗
  78. ║  ■ PYRAMID Multi-Node Support ■                                        ║
  79. ╚════════════════════════════════════════════════════════════════════════╝
  80. PYRAMID is completely Multi-Node aware.  If you are running more than one
  81. node, simply create different configuration files for each node and include
  82. that configuration filename on the command line!
  83.  
  84.  
  85. ╔════════════════════════════════════════════════════════════════════════╗
  86. ║  ■ PYRAMID Adopted Screen ■                                            ║
  87. ╚════════════════════════════════════════════════════════════════════════╝
  88. After the OPENING.ANS is displayed there is an optional screen called 
  89. ADOPTED.ANS that will be displayed.  This screen is completely user
  90. configurable.  You can thank someone for registering the door for you or
  91. try to encourage someone to do it for you or give them instructions for
  92. the door, whatever you like!
  93.  
  94.  
  95. ╔════════════════════════════════════════════════════════════════════════╗
  96. ║  ■ PYRAMID How to Play ■                                               ║
  97. ╚════════════════════════════════════════════════════════════════════════╝
  98. Pyramid Solitaire is one of the easiest solitaire games to understand,
  99. however it is not that easy to win!  Below is a copy of the HELP.ANS (in
  100. ASCII format):
  101.  
  102. ┌──────────────────────────────────────────────────────────────────────────┐
  103. │                     The Rules of Pyramid Solitaire.                      │
  104. │                                                                          │
  105. │ Layout:  The cards are dealt with 28 in a pyramid (triangle) shape       │
  106. │          leaving 24 cards in the stock pile.                             │
  107. │   Play:  From the available cards, discard pairs of cards that total     │
  108. │          thirteen.  Discard KINGS singly.  The stock pile may be turned  │
  109. │          over to the wastepile one at a time by hitting <enter> or <+>.  │
  110. │          Any card that is NOT covered may be played!                     │
  111. │Scoring:  10 points for each card removed & 480 points if the game is won.│
  112. │          A total of 1100 points can be awarded per game!                 │
  113. │Winning:  The game is considered won when ALL cards have been discarded!  │
  114. │                                                                          │
  115. │Valid Pairing of cards:                                                   │
  116. │   ┌────┐┌────┐  ┌────┐┌────┐  ┌────┐┌────┐  ┌────┐┌────┐  ┌────┐┌────┐   │
  117. │   │A   ││Q   │  │2   ││J   │  │3   ││10  │  │4   ││9   │  │5   ││8   │   │
  118. │   │   A││   Q│  │   2││   J│  │   3││  10│  │   4││   9│  │   5││   8│   │
  119. │   └────┘└────┘  └────┘└────┘  └────┘└────┘  └────┘└────┘  └────┘└────┘   │
  120. │   ┌────┐┌────┐  ┌────┐                                                   │
  121. │   │6   ││7   │  │K   │                                                   │
  122. │   │   6││   7│  │   K│   NOTE:  The suit DOES NOT play a factor!         │
  123. │   └────┘└────┘  └────┘                                                   │
  124. └──────────────────────────────────────────────────────────────────────────┘
  125.  
  126.  Game Limit:  There is a default game limit of 10, this value can be changed
  127.           from 0-65534 from within the PYRAMID.KEY, but ONLY in the 
  128.           registered version!
  129.  
  130. ╔════════════════════════════════════════════════════════════════════════╗
  131. ║  ■ PYRAMID Scoring ■                                                   ║
  132. ╚════════════════════════════════════════════════════════════════════════╝
  133.  Scoring is simple, 10 points for every card removed.  100 points will be 
  134.  awarded when the pyramid is totally cleared and an extra 480 points when a
  135.  game is won.  There is a maximum of 1100 points per game (if won).
  136.  
  137.  Scores are kept for one month in the PYRAMID.DAT file and the Top Ten
  138.  is kept in PYRAMID.SCR.  An alltime high is kept in ALLTIME.DAT.
  139.  PYRAMID.MB4 will contain the previous months scores!
  140.  
  141.  On the first of the month PYRAMID.DAT will be removed and PYRAMID.SCR
  142.  will be renamed to PYRAMID.MB4 when the first player enters the door!
  143.  
  144.  When in the game 'V' will display the scores, with the Alltime high and
  145.  last months highest score first, with this months top ten following in 
  146.  the next screen.
  147.  
  148. ╔════════════════════════════════════════════════════════════════════════╗
  149. ║  ■ PYRAMID Files in Archive ■                                          ║
  150. ╚════════════════════════════════════════════════════════════════════════╝
  151.  
  152. Your TPYRA120.ARJ file should contain the following files:
  153.  
  154.       Pyramid.exe -> The Executable File.
  155.       Pyramid.doc -> This Document File.
  156.       Pyramid.reg -> Registration Form.
  157.       Pyramid.his -> History of Releases.
  158.       Pyramid.upg -> Upgrade information.
  159.       Support.doc -> How to get Support.
  160.  
  161.       Pbullet.exe -> Creates External Bulletins
  162.       Pbullet.cfg -> Configuration File for Pbullet.exe.
  163.      
  164.       File_id.diz -> Short Program Description.
  165.  
  166.       Pyramid.key -> Registration Key File.
  167.  
  168.       Pyramid.cfg -> Example Configuration File. 
  169.         Local.cfg -> Example Local Configuration File.
  170.  
  171.          Main.ans -> Ansi Main Menu.
  172.          Help.ans -> Ansi Help Screen.
  173.       Adopted.ans -> Ansi Adopted Screen.
  174.       Opening.ans -> Ansi Opening Screen.
  175.      Calendar.ans -> Ansi Calendar Screen (for Make up Days).
  176.       Cleared.ans -> Ansi Screen Shown When Pyramid is Cleared.
  177.       Wongame.ans -> Ansi Screen Shown When a Game is Won.
  178.  
  179.      Edituser.exe -> Data File Editor.
  180.      Edituser.doc -> Document File for Edituser.
  181.  
  182.       
  183.        ═════ Files Created at Run-Time ═════
  184.       Pyramid.dat -> User Data, contains the Username,
  185.              Last date played, games won, total points,
  186.              and games played.
  187.       Pyramid.scr -> Top Ten Scores Data File.
  188.       Alltime.dat -> Alltime high Data File.
  189.       Pyramid.mb4 -> Scores From the Month Before.
  190.  
  191. ╔════════════════════════════════════════════════════════════════════════╗
  192. ║  ■ PYRAMID Configuration File ■                                        ║
  193. ╚════════════════════════════════════════════════════════════════════════╝
  194. The Configuration file may be named anything you wish to name it, but it must
  195. be included on the command line for PYRAMID to use it.  If you do not specify
  196. a configuration file on the command line then PYRAMID will try to use 
  197. PYRAMID.CFG, if that is not found the program will abort.
  198.  
  199. Everything that you need to know about the Configuration file is within the
  200. configuration file.....
  201.  
  202. ╔════════════════════════════════════════════════════════════════════════╗
  203. ║  ■ PYRAMID Registration Information ■                                  ║ 
  204. ╚════════════════════════════════════════════════════════════════════════╝
  205. Registration of PYRAMID reflects the concept of Shareware.
  206.  
  207. Please see PYRAMID.REG for details on registering.
  208.  
  209. ╔════════════════════════════════════════════════════════════════════════╗
  210. ║  ■ PYRAMID Registered Options ■                                        ║
  211. ╚════════════════════════════════════════════════════════════════════════╝
  212. Here is an example of a key file:
  213.  
  214. [U N R E G I S T E R E D]
  215. 0000000000
  216. 10
  217. black
  218. white
  219. 3
  220. 3
  221. ;;;;;;;;;;
  222. All SEVEN lines must be in here, anything after the first SEVEN lines
  223. is considered comment!
  224.  
  225. This file must be renamed to PYRAMID.KEY
  226.  
  227. Line 1:  Name Registered Under, Maximum of 40 characters.
  228. Line 2:  Special Registration Number.
  229. Line 3:  Total Games a User May Play, 0-65534!
  230. Line 4:  Background Color ie:
  231.  
  232.       black
  233.       blue
  234.       green
  235.       cyan
  236.       red
  237.       magenta
  238.       brown
  239.       white
  240.  
  241. Line 5:  Card Color ie:
  242.  
  243.       black   <---NOT RECOMMENDED
  244.       blue
  245.       green
  246.       cyan
  247.       red     <---NOT RECOMMENDED
  248.       magenta
  249.       brown
  250.       white
  251.  
  252. Line 6:  Total Times a User May Go Throught the Stock Pile, 1-65534!
  253. Line 7:  Total Make Up Days Allowed Per Day, 1-65534!
  254.  
  255. Lines 3, 4, 5, 6, and 7 can be changed but will only take effect when the
  256. door is registered!
  257.  
  258. The color may also be changed by the user while playing the door by using
  259. the <C> = Change Colors command, this is then stored in their record in
  260. the data file and they will not have to change it again unless they want to!
  261.  
  262. ╔════════════════════════════════════════════════════════════════════════╗
  263. ║  ■ PYRAMID External Bulletins ■                                        ║
  264. ╚════════════════════════════════════════════════════════════════════════╝
  265. PYRAMID can create external bulletins via PBULLET.EXE.  PBULLET will read
  266. the PBULLET.CFG and will create any or all of the Ansi, Ascii, or Rip
  267. bulletins.  Simply run PBULLET and it will pick up the default PBULLET.CFG
  268. configuration file, or specify which configuration file you would like to
  269. use on the command line:
  270.  
  271. PBULLET <configfilename>
  272.  
  273. PBULLET must reside in the same directory as PYRAMID and PYRAMID needs to
  274. be registered.  If PYRAMID is NOT registered, a message will be displayed
  275. and the program will exit!
  276.  
  277. Please see the enclosed PBULLET.CFG for details on how to configure PBULLET.
  278.  
  279. ╔════════════════════════════════════════════════════════════════════════╗
  280. ║  ■ PYRAMID V1.20 Credits and Many Thanks ■                             ║
  281. ╚════════════════════════════════════════════════════════════════════════╝
  282. Special thanks go to Brian Pirie who wrote "OpenDoors, Door Programming
  283. Toolkit Version 5.10" with which PYRAMID was created!
  284.  
  285. A very special thanks go to the following for spending the time to BETA
  286. test the earliest versions of the door:
  287.  
  288. Cammy Cochrane
  289. Bob Hindal
  290. Della Moore
  291. Steve Newman
  292. Mike Noftzger
  293. Brian Tremblay
  294. George Wheeler
  295.  
  296. Full support will be given on The Ultimate House Of Fun BBS, please call we
  297. would like to hear any concerns or comments!
  298.  
  299. ╔════════════════════════════════════════════════════════════════════════╗
  300. ║  ■ PYRAMID Warranty and Disclaimer ■                                   ║
  301. ╚════════════════════════════════════════════════════════════════════════╝
  302.  = Warranty =
  303. This product is provided "as is" without warranty of any kind.  The entire
  304. risk as to the results and performance of the program is assumed by you.
  305. Futhermore, we the authors do not warrant, guarantee, or make any represent-
  306. tions regarding the use of, or the results of the use of the program, and you
  307. rely on the program and results solely at your own risk. We the authors cannot
  308. accept responsibility for system damage, either directly or indirectly from
  309. the use of this product.
  310.  
  311.  = Disclaimer =
  312. The Authors of this program, The Ultimate House Of Fun BBS and its Co-sysops
  313. are in no way responsible for any damages sustained either directly
  314. or indirectly from the use of PYRAMID.  Also if the file has been
  315. modified in any way we will take no responsibility for it's use Whatsoever!
  316. The .EXE file has been tested on several machines, from 286's to 486's and
  317. worked perfectly on all. If you should have any problems with this file
  318. please call The Ultimate House Of Fun BBS to obtain a good copy.
  319.  
  320. The latest version of this program may be FREQ'd by using:
  321.  
  322.   PYRAMID
  323.